|
|
PBUnlockRangeAsync |
||||
| Header: | Files.h | Carbon status: | Supported | |
Unlocks a portion of a file that was previously locked by a call to PBLockRange.
OSErr PBUnlockRangeAsync (
ParmBlkPtr paramBlock
);
A pointer to a basic File Manager parameter block.
A result code.
The relevant fields of the parameter block are:
On input, a pointer to a completion function.
On output, the result code of the function.
On input, the file reference number
On input, the number of bytes in the range.
On input, the positioning mode.
On input, the positioning offset.
The PBUnlockRangeAsync function unlocks a portion of a file that you locked with PBLockRangeAsync. You specify the range by filling in the ioReqCount, ioPosMode, and ioPosOffset fields as described in the discussion of PBLockRangeAsync. The range of bytes to be unlocked must be the exact same range locked by a previous call to PBLockRangeAsync.
If for some reason you need to unlock a range whose beginning or length is unknown, you can simply close the file. When a file is closed, all locked ranges held by the user are unlocked.
The PBUnlockRangeAsync function does nothing if the file specified in the ioRefNum field is open with shared read/write permission but is not located on a remote server volume or is not located under a share point on a local volume.
Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.
© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)